/*-------------------------------------------------------------------------
 *
 * pgtz.h
 *	  时区库集成功能
 *
 * 注意：此文件仅包含时区库私有的定义。公共定义在pgtime.h中。
 *
 * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
 *
 * IDENTIFICATION
 *	  src/timezone/pgtz.h
 *
 *-------------------------------------------------------------------------
 */
#ifndef _PGTZ_H
#define _PGTZ_H

#include "pgtime.h"
#include "tzfile.h"


#define SMALLEST(a, b)	(((a) < (b)) ? (a) : (b))
#define BIGGEST(a, b)	(((a) > (b)) ? (a) : (b))

struct ttinfo
{								/* 时间类型信息 */
	int32		tt_utoff;		/* UT偏移量（秒） */
	bool		tt_isdst;		/* 用于设置tm_isdst */
	int			tt_desigidx;	/* 缩写列表索引 */
	bool		tt_ttisstd;		/* 转换为标准时间 */
	bool		tt_ttisut;		/* 转换为UT */
};

struct lsinfo
{								/* 闰秒信息 */
	pg_time_t	ls_trans;		/* 转换时间 */
	int64		ls_corr;		/* 应用的修正 */
};

struct state
{
	int			leapcnt;
	int			timecnt;
	int			typecnt;
	int			charcnt;
	bool		goback;
	bool		goahead;
	pg_time_t	ats[TZ_MAX_TIMES];
	unsigned char types[TZ_MAX_TIMES];
	struct ttinfo ttis[TZ_MAX_TYPES];
	char		chars[BIGGEST(BIGGEST(TZ_MAX_CHARS + 1, 4 /* gmt的大小 */ ),
							  (2 * (TZ_STRLEN_MAX + 1)))];
	struct lsinfo lsis[TZ_MAX_LEAPS];

	/*
	 * 用于早期时间或没有转换的时间类型。对于最新的tzdb版本，它始终为
	 * 零。对于tzdb 2018e或更早的数据，可能为非零。
	 */
	int			defaulttype;
};


struct pg_tz
{
	/* TZname包含时区的规范格式名称 */
	char		TZname[TZ_STRLEN_MAX + 1];
	struct state state;
};


/* 在pgtz.c中 */
extern int	pg_open_tzfile(const char *name, char *canonname);

/* 在localtime.c中 */
extern int	tzload(const char *name, char *canonname, struct state *sp,
				   bool doextend);
extern bool tzparse(const char *name, struct state *sp, bool lastditch);

#endif							/* _PGTZ_H */
